home *** CD-ROM | disk | FTP | other *** search
/ Aminet 35 / Aminet 35 (2000)(Schatztruhe)[!][Feb 2000].iso / Aminet / util / cli / iconcopy.readme < prev    next >
Encoding:
Text File  |  2000-01-03  |  4.5 KB  |  147 lines
  1. Short:    V1.5 of the shell command to copy icons
  2. Author:   sebauer@t-online.de (Sebastian Bauer)
  3. Uploader: sebauer@t-online.de (Sebastian Bauer)
  4. Version:  1.5
  5. Type:     util/cli
  6. Requires: OS 2.0
  7. Kurz:     V1.5 des Shell Befehls zum Iconkopieren
  8.  
  9. IconCopy is a small and simple shell command to copy an icon image
  10. from a source to a destination. No tooltypes will be overwritten if
  11. there is already an icon at the destination. If it is not started on
  12. a OS 3.5 system it uses the newicon.library if available.
  13.  
  14. I wrote it because I needed something like this for the Installation
  15. Script of SimpleFind. The installer itself cannot do this at this
  16. moment (I think) and so IconCopy was born.
  17.  
  18. Feel free to use and spread it.
  19.  
  20.  
  21. Usage
  22. ~~~~~
  23. Since IconCopy is a shell command (it is pure, so it can be made resident)
  24. it can not be started from Workbench ;-) (but if you do it anywhy IconCopy
  25. will do nothing) and so only a shell template exists:
  26.   SOURCE/A,DEST,CHECK/S,CONVERTNEWICON/S,DROPPLANAR/S,FORCE/S,
  27.   HOLDDESTPLANAR/S,UPDATE/S,VERBOSE/S
  28.  
  29. SOURCE/A
  30.  The source icon (with or without ".info")
  31.  
  32. DEST
  33.  The destination (with or without ".info")
  34.  If there is already an icon, only the image is copied otherwise the
  35.  complete icon is copied.
  36.  Starting with version 1.5 you can omit this argument. Then the icon
  37.  is written back to the SOURCE so IconCopy can also be used to be a
  38.  converter.
  39.  
  40. CHECK/S
  41.  If the DEST file (without .info) doesn't exists the icon is not copied.
  42.  Ignored if no DEST icon is setted.
  43.  
  44. CONVERTNEWICON/S
  45.  Every NewIcon which is copied by IconCopy is coverted to the OS3.5
  46.  icon format. OS3.5 is required for this function.
  47.  
  48. DROPPLANAR/S
  49.  The icon which is written doesn't contain the old (pre OS3.5) planar icon
  50.  infomation. If the icon has only a planar image nothing will happen.
  51.  OS3.5 is required for this function.
  52.  
  53. FORCE/S
  54.  Overwrite the icon even if it is delete protected
  55.  
  56. HOLDDESTPLANAR/S
  57.  Copies only the NewIcon or OS3.5 Icon but doesn't overwrite the old
  58.  planar image.
  59.  
  60. UPDATE/S
  61.  If dest icon exists, the tooltypes of the source icon, which don't
  62.  exist on in the dest icon are also copied, but marked as deactivated
  63.  (via the '()' pair).
  64.  Ignored if no DEST icon is setted.
  65.  
  66. VERBOSE/S
  67.  Prints some messages.
  68.  
  69. Example
  70. ~~~~~~~
  71. IconCopy SYS:Prefs RAM:Test
  72. (copies the SYS:Prefs icon to RAM:Test)
  73.  
  74. For a more complete example, look into the installation script for
  75. SimpleFind3.
  76.  
  77. History
  78. ~~~~~~~
  79. Version 1.5 (27.11.99)
  80.  - changed DEST/A to DEST (suggested by by Rolf Max Rotvel)
  81.  - added FORCE/S and VERBOSE/S argument (suggested by by Rolf Max Rotvel)
  82.  - now it is possible also to use names with ".info"
  83.    (suggested by Jürgen Urbanek)
  84.  - added HOLDDESTPLANAR/S argument (Jürgen Urbanek)
  85.  - included a shell script to convert all NewIcons to OS3.5 ones in
  86.    a drawer and sub drawers (by Rolf Max Rotvel)
  87.  
  88. Version 1.4 (07.11.99)
  89.  - added DROPPLANAR/S argument
  90.  - if a dest icon existed the position information got overwritten on OS3.5
  91.    (reported by Richard R. Baud)
  92.  
  93. Version 1.3 (31.10.99)
  94.  - added CONVERTNEWICON/S argument
  95.  
  96. Version 1.2 (20.10.99)
  97.  - supports the new icon.library version 44 API
  98.  
  99. Version 1.1 (02.01.99)
  100.  - added UPDATE/S Argument (suggested by Nils Görs)
  101.  - forgot to close the newicon.library
  102.  
  103. Version 1.0 (23.11.98)
  104.  - first public release
  105.  
  106. Future
  107. ~~~~~~
  108. Enough for my needs...but I'm open for suggestions
  109. (however I think there is room for many improvments)
  110.  
  111.  
  112. Notes
  113. ~~~~~
  114. Since probably no normal person will install this command on
  115. his/her system you must include it, if your installation script
  116. use this command. However it's enough to include the binary only.
  117.  
  118.  
  119. Visit my homepage
  120.   http://home.t-online.de/home/sebauer/
  121.   (german version)
  122.  
  123.   http://home.t-online.de/home/sebauer/english.html
  124.   (english version)
  125.  
  126. Here you can find the latest version of my other programs
  127. SimpleFind, SimpleHTML, SimplePac and of course IconCopy.
  128.          __
  129.         / /
  130.    __  / /   Only Amiga makes it possible...
  131.    \ \/ /
  132.     \__/
  133.  
  134.  
  135. ============================= Archive contents =============================
  136.  
  137. Original  Packed Ratio    Date     Time    Name
  138. -------- ------- ----- --------- --------  -------------
  139.      632     278 56.0% 31-Oct-99 16:34:34  IconCopy.info
  140.      679     390 42.5% 24-Nov-99 14:44:58 +converticons35
  141.      533     319 40.1% 14-Nov-99 20:33:42 +converticons35.readme
  142.     3296    2198 33.3% 27-Nov-99 10:17:24 +IconCopy
  143.     3981    1779 55.3% 27-Nov-99 10:19:02 +ReadMe
  144.      831     306 63.1% 27-Nov-99 10:19:02 +ReadMe.info
  145. -------- ------- ----- --------- --------
  146.     9952    5270 47.0% 28-Nov-99 05:07:46   6 files
  147.